home *** CD-ROM | disk | FTP | other *** search
/ Aminet 5 / Aminet 5 - March 1995.iso / Aminet / util / misc / PhoneBookV1_8.lha / PhoneBook.docs < prev    next >
Text File  |  1994-01-12  |  8KB  |  218 lines
  1.  
  2.                   Welcome to the Docs for Phonebook V1.8
  3.  
  4.                               January 12, 1994
  5.  
  6.  
  7.                     How the Heck Do I use this Program?
  8.  
  9.  
  10.     PhoneBook is a fairly straight forward program to use, I'm sure you've
  11. already tried the program before bothering to read the documentation
  12. anyways! 
  13.     
  14.     Okay, Here how to use the program. There are several String Gadgets 
  15. at the bottom center of the screen labled: First Name, Last Name, Phone, 
  16. and Address. You just enter in the information that you desire and it
  17. will show up on the big dark grey box in the middle of the screen under
  18. a highlight bar. There are 5 lines for the address, the 5th is usually 
  19. used as just an information gadget. 
  20.  
  21.     To move the Highlight bar just move the mouse pointer inside the big 
  22. box and click the LEFT mouse button to scroll DOWN the list, and the RIGHT
  23. mouse button will Scroll UP the entries. When the Top or bottom of the 
  24. list is reached and you try to scroll past it, it will loop around to 
  25. the Beginning if you tried scrolling past the End, and will loop to the 
  26. End if scrolling past the Beginning was Attempted.
  27.  
  28.     On the lower right side of the screen there are buttons for A-Z, and 
  29. 1st and Last. Clicking on a letter will bring the Highlight bar to the
  30. first entry in the PhoneBook with a Last name beginning with that Letter.
  31. And clicking on 1st will of course, bring you to the first entry, and the
  32. last will bring you to the Last Entry. 
  33.  
  34.     To Put a new entry in the phonebook the Highlight bar has to be on the
  35. Empty Entry, which is always the last entry in the PhoneBook. So, by 
  36. clicking on LAST will allow you to immediately enter a new name.
  37.  
  38.     The Sort Button will sort the Names Alphabetically by the last name,
  39. and the Remove Button will remove whatever entry the Highlight bar is 
  40. currently on. A Requester will pop up asking if your sure you want to 
  41. delete that entry.
  42.  
  43.     A requester will also pop up asking if your sure you want to Quit 
  44. when the Quit Button has been pressed.
  45.  
  46.     To Load or Save a PhoneBook data file just click on the respective 
  47. gadget and the standard ASL file requester will pop up. Just enter the 
  48. filename and click OK. 
  49.  
  50.     The default file name for the phonebook datafile is S:PhoneNumbers, if
  51. this file exists it will be automatically loaded up each time you startup
  52. the program.
  53.  
  54.  
  55.     That's about it, Enjoy. 
  56.  
  57.                     Brian Olson
  58.  
  59.  
  60.  
  61.    Information on Updates that PhoneBook has gone through to reach it's 
  62.                       current state of Version 1.8.
  63.  
  64.  
  65. "Version 1.1 updates"
  66.  
  67.     Used to have to Click on EAch consecutive Gadget for entering data
  68. on your entry. Now you can just hit return and the Selected gadget will 
  69. move onto the next. 
  70.     First Name -> Last Name -> Phone -> Address Lines -> First Name
  71.  
  72.  
  73. "Version 1.2 and 1.3 updates"
  74.  
  75.         Just messed around with IDCMP detection, I finally got it 
  76. to work better.  Version 1.2 and 1.3 are just improvements on the detection
  77. of Gadget clicking.
  78.  
  79.  
  80. "Version 1.4 updates"
  81.  
  82.    - I Put another gadget in the Address Box (supports 50 characters, I 
  83.      think?) as requested by a user of this program (Thanks Eric!)
  84.      Use it for whatever you want, I think Eric wants it to put little 
  85.      notes in.
  86.          As a Result of this I had to add an extra line in the PhoneBook 
  87.      data file for each entry so the older data files wont work, But don't
  88.      worry, It can be Upgraded Easy.   See Below.
  89.  
  90.  
  91. "Version 1.5 updates"
  92.  
  93.    -  The nicest update to this version is the addition of the buttons
  94.       A through Z, 1st and Last. Clicking on one of the letters will 
  95.       move the Highlighter Bar to the first Entry with a Last name starting
  96.       with the letter you selected. If there is no match the Highlight bar
  97.       will not move. The 1st button will bring you to the first entry, and
  98.       the Last button will bring you to the last entry (The Blank Entry
  99.       Actually)  
  100.  
  101.    -  When you Scroll past the Last Entry (The Blank one) it now loops up
  102.       to the first entry, As with the First entry going to the Last one 
  103.       when trying to scroll before it.
  104.  
  105.    -  The program now checks to make sure it is indeed it's own data file
  106.       that you are trying to load, as it used to crash if it wasn't. Do do
  107.       this I had to add one line to the beginning of the datafile. The 
  108.       included program, datafile1.4to1.5 will make the change for you. If 
  109.       you have a version before 1.4 then use the program datafile-to-1.4 
  110.       followed by datafile1.4to1.5. 
  111.  
  112.  
  113. "Updating your PhoneBook Data file"
  114.  
  115.     If you have an Older version of a PhoneBook Datafile, you DON'T have
  116. to enter it in again. I have included two update programs in this
  117. archive. 
  118.  
  119.     If you have a datafile from a version of Phonebook before 1.4, then
  120. you have to first use the program called "datafile-to-1.4". From CLI, just
  121. type 
  122.         datafile-to-1.4 <old version name> <new version name>
  123.  
  124.     where <old version name> is the name of your old data file and
  125.           <new version name> is what you want to call the new version
  126.                  of your datafile.
  127.  
  128.     Your datafile is now of version 1.4. Now you have to update it
  129. again to 1.5. 
  130.  
  131.    If you have a datafile from version 1.4 use the program 
  132. "datafile1.4-to-1.5" From CLI, type
  133.  
  134.         datafile1.4-to-1.5 <old version name> <new version name>
  135.  
  136.     Now your datafile should work with Version 1.5 and Version 1.6.
  137.  
  138.  
  139.  
  140. "Version 1.6 updates"
  141.  
  142.     Since the Remove and Quit Gadgets, are a bit Final, I decided to
  143. put some "Are you sure?"'s in.
  144.  
  145.     Whenever you Click on the Quit gadget a requester will pop up asking
  146. you if you're sure you want to Quit. Just Click on Yes to quit and NO to
  147. get back to the program.
  148.  
  149.     A requester also pops up when you click on the Remove gadget. Again, 
  150. click on YES to delete the Entry, or NO to leave the entry in the 
  151. Phonebook.
  152.  
  153. "Version 1.7 updates"
  154.  
  155.     The Program used to open up it's own screen and colors, I decided
  156. to have it just open up a window from the workbench screen. As a result of
  157. this the colors are now the same as that of the workbench, and not the 
  158. custom colors like before. Therefore I redesigned a couple of the graphic
  159. displays, for the better i hope! heh. It looks really nice now!
  160.  
  161.     The BEST improvement to this version is that it now has file 
  162. requesters, it uses the standard ASL requester.  Makes Saving and Loading 
  163. much nicer then before!  
  164.  
  165. "Version 1.8 updates"
  166.  
  167.      PhoneBook now looks for a file called "PhoneNumbers" in the s: 
  168. directory when it is executed. If the file is found then it will be 
  169. automatically loaded up for you, if the file is not found the program will
  170. start up blank just like before. So if you already have a phonebook data
  171. file rename it as follows
  172.  
  173.         rename <old phonebook data file>  s:PhoneNumbers
  174.  
  175. Now you don't have to bother loading it up each time you run the program.
  176.  
  177.  
  178.  
  179.  
  180.                                 The Author
  181.  
  182.      Well Hello. I'm Glad to see that your atleast taking a look at my 
  183. program, not necessarily liking it!  I'm sure you will. 
  184.  
  185.      
  186.      Why Did I write This? There are a LOT of other Phone Book programs
  187. around already! 
  188.      I wrote it because I wanted to learn how to use Gadgets
  189. in C, and I was sick of using my term program to store my phone
  190. numbers!
  191.      This is actually my first attemp at writting such an indepth program 
  192. in C. I've had to learn most of it by myself, and a Lattic C instruction
  193. manual written by a C Users Group that I don't recall at the Moment. But 
  194. Thanks a LOT to those who wrote it!  
  195.      There is no one in my area to ask questions so i've had my share
  196. of problems getting things to work. But I've learned a LOT writing this 
  197. program, I'm glad I wrote it!  I hope you Enjoy it.
  198.  
  199.  
  200. If you Like this Program, Please Send $10 to encourage updates to
  201.  
  202.                                  Brian Olson
  203.                                  11 Limetree Lane
  204.                                  Liverpool, NY 13090
  205.                                  USA
  206.  
  207. If you want to get intouch with me, you can either mail me, or get intouch 
  208. with me by one of the BBS's around me. 
  209.  
  210.     Gates Way BBS        Line 1:  (315) 592-8034   14.4k Dual 
  211.                    Line 2:  (315) 598-8730   14.4k HST
  212.  
  213.     Day Dreamers BBS     Line 1:  (315) 437-0151   14.4k Dual
  214.                  Line 2:  (315) 437-0258   14.4K Dual
  215.  
  216.  
  217.     My Handle is  Salty Dog.
  218.